package com.nidu.demo.post.gateway;

import com.alibaba.cola.dto.PageResponse;
import com.nidu.demo.post.model.Position;
import com.nidu.demo.post.model.PositionCriteria;

import java.util.Set;
import java.util.List;

/**
 * 职位网关接口
 * 供领域层调用，实现跨上下文/基础设施的职位数据访问
 *
 * @author auto
 */
public interface PositionGateway {

    /**
     * 创建职位
     *
     * @param post 职位信息
     * @return 创建后的职位
     */
    Position create(Position post);

    /**
     * 修改职位
     *
     * @param post 职位信息
     * @return 修改后的职位
     */
    Position update(Position post);

    /**
     * 删除单个职位
     *
     * @param id 职位ID
     */
    void deleteById(Long id);

    /**
     * 批量删除职位
     *
     * @param ids 职位ID列表
     */
    void deleteByIds(Set<Long> ids);

    /**
     * 根据职位ID查询
     * @param id 职位ID
     * @return 职位信息
     */
    Position getById(Long id);

    /**
     * 根据职位ID列表查询
     * @param ids 职位ID列表
     * @return 职位列表
     */
    List<Position> getByIds(Set<Long> ids);

    /**
     * 根据职位编码和公司ID查询
     *
     * @param code 职位编码
     * @param companyId 公司ID
     * @return 职位信息
     */
    Position getByCodeAndCompanyId(String code, Long companyId);

    /**
     * 列表查询
     * @param criteria 查询条件
     * @return 职位列表
     */
    List<Position> listByCondition(PositionCriteria criteria);

    /**
     * 分页查询
     * @param criteria 查询条件
     * @return 分页结果
     */
    PageResponse<Position> pageByCondition(PositionCriteria criteria);

}